home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / csaswitch.z / csaswitch
Encoding:
Text File  |  2001-04-17  |  16.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      csaswitch - checks the status of, enables or disables the different types
  10.      of Comprehensive System Accounting (CSA), and switches accounting files
  11.      for maintainability
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _c_h_e_c_k _----_nnnn _n_a_m_e
  15.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _h_a_l_t
  16.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _o_f_f _----_nnnn _n_a_m_e_l_i_s_t
  17.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _o_n [_----_nnnn _n_a_m_e_l_i_s_t] [_----_mmmm _m_e_m_t_h_r_e_s_h_o_l_d] [_----_tttt _t_i_m_e_t_h_r_e_s_h_o_l_d] [_----_PPPP _p_a_t_h_n_a_m_e]
  18.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _s_t_a_t_u_s
  19.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _s_w_i_t_c_h
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command checks the current status of the different types of
  23.      Comprehensive System Accounting (CSA), enables or disables them, and
  24.      switches files for maintainability.
  25.  
  26.      You can use _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh to check the current status of an accounting type
  27.      or to report the status of all types.  These functions do not require any
  28.      privileges.
  29.  
  30.      Users must have the _CCCC_AAAA_PPPP______AAAA_CCCC_CCCC_TTTT______MMMM_GGGG_TTTT capability to enable or disable an
  31.      accounting type, or to switch files for maintainability.  See the
  32.      capability(4) and capabilities(4) man pages for more information on the
  33.      capability mechanism that provides fine grained control over the
  34.      privileges of a process.
  35.  
  36.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command accepts the following options:
  37.  
  38.      _----_DDDD _l_e_v_e_l     Sets the debug level.  Level 1 is slightly verbose; level 3
  39.                   is the most verbose.  Debug output is written to standard
  40.                   error.  By default, debugging is turned off (level 0).
  41.  
  42.      _----_cccc _c_o_m_m_a_n_d   Specifies the accounting command.
  43.  
  44.                   CCCCoooommmmmmmmaaaannnndddd         DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  45.  
  46.                   _cccc_hhhh_eeee_cccc_kkkk           Reports the status for an accounting type
  47.  
  48.                   _hhhh_aaaa_llll_tttt            Turns off all accounting types
  49.  
  50.                   _oooo_ffff_ffff             Disables one or more types of accounting
  51.  
  52.                   _oooo_nnnn              Enables one or more types of accounting
  53.  
  54.                   _ssss_tttt_aaaa_tttt_uuuu_ssss          Reports the status of all types of
  55.                                   accounting
  56.  
  57.                   _ssss_wwww_iiii_tttt_cccc_hhhh          Specifies that a new accounting file should
  58.                                   be created to maintain manageable files.
  59.                                   Suppose the accounting filename is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.  _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh moves
  75.                                   the current accounting file
  76.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt to the next
  77.                                   available file _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt_**** and
  78.                                   then calls _aaaa_cccc_cccc_tttt_cccc_tttt_llll(3C) using the file
  79.                                   argument /_v_a_r/_a_d_m/_a_c_c_t/_d_a_y/_p_a_c_c_t.  In this
  80.                                   way, accounting data is not lost, and
  81.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt remains the current
  82.                                   file.
  83.  
  84.      _----_nnnn _n_a_m_e      Specifies the _n_a_m_e of the accounting type for which a
  85.                   request is being made.  The _n_a_m_e_l_i_s_t argument for the _oooo_ffff_ffff
  86.                   and _oooo_nnnn commands can be a single name or a comma-separated
  87.                   list of names.
  88.  
  89.                   Valid process accounting names are:
  90.  
  91.                   NNNNaaaammmmeeee                DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  92.  
  93.                   _cccc_ssss_aaaa                 CSA accounting
  94.  
  95.                   Valid daemon  names are:
  96.  
  97.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  98.  
  99.                   _nnnn_qqqq_ssss            Network Queuing System (NQS) daemon
  100.                                  accounting
  101.  
  102.                   _wwww_kkkk_mmmm_gggg           Workload management daemon accounting
  103.  
  104.                   _tttt_aaaa_pppp_eeee           Tape daemon accounting
  105.  
  106.                   Valid record names (linked to the CSA base record):
  107.  
  108.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  109.  
  110.                   _iiii_oooo             Input and output data record
  111.  
  112.                   _mmmm_eeee_mmmm            Memory data record
  113.  
  114.                   Valid threshold names are:
  115.  
  116.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  117.  
  118.                   _mmmm_eeee_mmmm_tttt           Memory threshold
  119.  
  120.                   _tttt_iiii_mmmm_eeee           CPU time threshold
  121.  
  122.      _----_mmmm _m_e_m_t_h_r_e_s_h_o_l_d
  123.                   Specifies the virtual memory high-water mark below which
  124.                   accounting records will not be written.  The threshold
  125.                   should be specified in Kbytes and as an integer. The _----_mmmm
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  137.  
  138.  
  139.  
  140.                   option must be specified when the _m_e_m_t operand is specified
  141.                   with the _----_nnnn option.
  142.  
  143.      _----_tttt _t_i_m_e_t_h_r_e_s_h_o_l_d
  144.                   Specifies the number of CPU seconds below which accounting
  145.                   records will not be written.  The threshold should be
  146.                   specified as an integer.  The _----_tttt option must be specified
  147.                   when the _t_i_m_e operand is specified with the _----_nnnn option.
  148.  
  149.      _----_PPPP _p_a_t_h_n_a_m_e  Specifies the path name of the file to which accounting data
  150.                   is written.  If the file exists, accounting records are
  151.                   appended to it.  Otherwise, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh creates a new file;
  152.                   and it sets the owner of the file to _aaaa_dddd_mmmm, the group to the
  153.                   value of the _CCCC_HHHH_GGGG_RRRR_PPPP parameter in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file, and
  154.                   the mode to _0000_6666_6666_4444.
  155.  
  156.      If you specify the _oooo_nnnn command and do not specify the _----_nnnn option, the
  157.      _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command gets information about which accounting types and
  158.      thresholds to enable from the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.
  159.  
  160.      When you enable an accounting type, if no accounting type is currently
  161.      on, you need to specify the accounting pathname via the _----_PPPP option.  If
  162.      you do not specify the _----_PPPP option, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh gets the pathname from the
  163.      _PPPP_AAAA_CCCC_CCCC_TTTT______FFFF_IIII_LLLL_EEEE parameter in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.  If that parameter does
  164.      not exist, then _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh uses _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.
  165.  
  166.      When you turn on a linked record, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns on _cccc_ssss_aaaa accounting (if
  167.      it is not on already) since there can be no linked records without the
  168.      base record.  The same happens when you set a threshold since thresholds
  169.      will not have any effect if _cccc_ssss_aaaa is not running.  Likewise, when you turn
  170.      off _cccc_ssss_aaaa accounting, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns off all the linked records and
  171.      thresholds.
  172.  
  173.      When you switch the _p_a_c_c_t file, if no accounting type is currently on,
  174.      _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns on accounting.  It gets information about which
  175.      accounting types and thresholds to enable from the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.
  176.      It also gets the accounting pathname from the _PPPP_AAAA_CCCC_CCCC_TTTT______FFFF_IIII_LLLL_EEEE parameter in the
  177.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.  If that parameter does not exist, then _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh
  178.      uses _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.
  179.  
  180. NNNNOOOOTTTTEEEESSSS
  181.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command does not support IRIX System V or extended
  182.      accounting.
  183.  
  184.      The _cccc_ssss_aaaa_cccc_kkkk_pppp_aaaa_cccc_cccc_tttt(1M) shell script invokes _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh to maintain accounting
  185.      files of a reasonable size.  You should run _cccc_ssss_aaaa_cccc_kkkk_pppp_aaaa_cccc_cccc_tttt(1M) periodically
  186.      by using _cccc_rrrr_oooo_nnnn(1M).
  187.  
  188. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  189.      Example 1:  The following command turns on _cccc_ssss_aaaa accounting with the
  190.      default _pppp_aaaa_cccc_cccc_tttt file:
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  203.  
  204.  
  205.  
  206.           _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh _----_cccc _oooo_nnnn _----_nnnn _cccc_ssss_aaaa
  207.  
  208.      Example 2:  The following command checks the status of _mmmm_eeee_mmmm accounting:
  209.  
  210.           _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh _----_cccc _cccc_hhhh_eeee_cccc_kkkk _----_nnnn _mmmm_eeee_mmmm
  211.  
  212.                #       Accounting status for Thu Feb  3 16:41:48 2000
  213.                #             Name      State   Value
  214.                              mem       On
  215.  
  216.  
  217. FFFFIIIILLLLEEEESSSS
  218.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff                         Accounting configuration file
  219.  
  220.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt               Current accounting file
  221.  
  222.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt_****              Switched accounting files
  223.  
  224. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  225.      cron(1M), csa(1M), csackpacct(1M), capability(4).
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.